跳到主要内容

广告api

拉起视频激励广告播放页面，并在得到播放结果时处理​

  • 参数
    • player (player) 需要展示广告的玩家
    • reward (string) 奖励名称
    • amount (number) 奖励数量
    • handler (function) 结果回调，回调参数类型为lua表, 含有成员
      • result 是否成功(必有)
      • msg 失败原因(必有)
      • rewardName 奖励名称(成功时有)
      • rewardAmount 奖励数量(成功时有)
  • 无返回
 
base.ad.show_reward_video_ad(player, '奖励名称', 1, function(res)
    if res.result then
        -- 成功，发放奖励
        log.info(player, 'show reward video ad success, with reward', res.rewardName, 'x', res.rewardAmount)
    else
        -- 没看够时长，中途退出或者意外错误
        log.error(player, 'show reward video ad failed:', res.msg)
    end
end)

一些注意事项​

为了区分游戏间的广告数据，每个游戏在后台都有一套面向广告来源的参数。在使用编辑器开发游戏时，初始是没有这些信息的，因此当开发者第一次在手机（安卓，因为目前只支持安卓）上测试时如果使用了上述api，会得到失败的结果。

此时分成两种情况，如果在tapcanry上进行测试，则会试图为开发者后台中的测试计划和小游戏填充广告参数，如果此时没有建立小游戏则只填充测试计划，当小游戏审核通过后第一次进入游戏仍得到失败的结果。

所以，目前大体的使用流程为，在游戏中使用api后，在tapcanary进行测试（得到失败结果），重启tapcanary后测试至流程跑通。如果此时没有创建小游戏则小游戏上线后需要预跑两次保证流程能通。

也适用于使用触发api的情况